package jsu.ljy.lostandfind.dao;

import java.util.Collections;
import java.util.List;

/**
 * 数据访问基础接口
 * 
 * <p>定义了所有数据访问对象需要实现的基本方法，提供了通用的CRUD操作。</p>
 * 
 * @author 罗嘉毅
 * @version 1.0
 * @since 2024-03-21
 * @param <T> 实体类型
 */
public interface BaseDao<T> {
    /**
     * 保存实体
     * 
     * @param entity 要保存的实体
     * @throws RuntimeException 当数据库操作失败时抛出
     */
    void save(T entity);

    /**
     * 更新实体
     * 
     * @param entity 要更新的实体
     * @throws RuntimeException 当数据库操作失败时抛出
     */
    void update(T entity);

    /**
     * 删除实体
     * 
     * @param id 实体ID
     * @throws RuntimeException 当数据库操作失败时抛出
     */
    void delete(Long id);

    /**
     * 根据ID查询实体
     * 
     * @param id 实体ID
     * @return 实体对象，如果不存在则返回null
     * @throws RuntimeException 当数据库操作失败时抛出
     */
    T findById(Long id);

    /**
     * 查询所有实体
     * 
     * @return 实体列表
     * @throws RuntimeException 当数据库操作失败时抛出
     */
    List<T> findAll();

    /**
     * 分页查询实体
     * 
     * @param page 页码（从1开始）
     * @param size 每页大小
     * @return 分页后的实体列表
     */
    default List<T> findByPage(int page, int size) {
        List<T> all = findAll();
        int start = (page - 1) * size;
        int end = Math.min(start + size, all.size());
        return start < end ? all.subList(start, end) : Collections.emptyList();
    }

    /**
     * 统计实体总数
     * 
     * @return 实体总数
     */
    default long count() {
        return findAll().size();
    }
} 